Skip to main content

Full text of "Icepik Users Guide (1983)(ICECO)[addendum]"

See other formats


Summary of Changes 

ICECO has made many enhancements to the ICEPIC software since the user's guide was 
printed. Some of these changes will alter the procedures described in the user's 
guide — these are detailed below and should be noted in your guide. 

IMPORTANT !! NOTE the CHANGES to the TUTORIAL, page 6.2 and to the Sample 
Application Requirements, Page 10.1. 

There are five major areas of enhancement: first, drivers are now supplied for all 
joystick ports (not just 2 and 4); second, a configuration program is included to 
make it much easier to select a driver and copy it to another diskette; third, 
XL/XE versions of the drivers are provided (which use no additional memory); 
fourth, new PHANDLER drivers which use page 3 and 4 are included; and lastly, the 
ICEGRAF drivers on the software diskette are ready-to-load for port 2 only — the 
CONFIGUR program must be used to generate ICEGRAF drivers for the other ports. 

User's Guide Changes 

Page 6.2, ICEGRAF Tutorial Step 1: Connect your ICEPIC to port 2. 

Page 6.2, ICEGRAF Tutorial Step 5: Load ICEGRAF.02H if you have an OKIDATA 
^compatible graphics printer, otherwise, loaitJCEGRAF.E2H.._ ___ 

Page 10.1, Sample Application Requirements, second paragraph: The selection 
criteria for all of the sample applications is built into CONFIGUR — just tell it 
your machine configuration plus the application you need and it will do the rest. 
If you have special needs, it will allow you to change the sample versions or to 
completely specify your own. The descriptions in the manual and below tell you 
what CONFIGUR will select for you — you will not have to follow the steps listed 
to create your driver since CONFIGUR does them automatically. 

Page 1.3, Equipment Needed: ICEPIC also works on 130XE models. 

Page 2.1, Hardware Setup: Step 3: You may plug the ICEPIC into any joystick 
jack. Step 4: If your printer has a 7/8 bit interface setup switch, make sure it 
is in the 8-bit position. 

Page 2.3, Checkout Procedure: Use ICECHK1 for joystick port 1 or 1CECHK3 for 
joystick ports 3. 

Page 3.3, Picking the Driver You Need: Load CONFIGUR from the ICEPIC software 
diskette to select, copy, rename, etc., the driver you need (for more details see 
the description of CONFIGUR below). 

Page 3.3, Self-Booting Programs: The XL drivers implement a special "re-boot key" 
— while holding any key except SHIFT or CTRL, press [BREAK] and a re-boot will 
occur (the drivers will remain active). 

-_ i - 

Page 3.3, System Reset: The page 3/4 drivers (nCB and nPS), high memory PHANDLER 
and SIOSIM drivers, and the XL drivers will be lost during normal system reset. 
The XL versions implement a special reset function ~ instead of [RESET], press 
[SHIFT]-[BREAK] and a system reset will occur without loss of the drivers. 

Page 4.1, PHANDLER versions: There are 18 versions of PHANDLER: 

. PHANDLER.nLM loads in low memory. 

. PHANDLER.nHM loads in high memory. 

. PHANDLER.nXL works with XL/XE models, replacing the OS cassette handler. 

. PHANDLER.nPS loads in the print buffer and the second half of page 4. 

. PHANDLER.nCB loads in the print buffer and the cassette buffer (first half 

of page 4). 

"n" can be 1, 2, 3, or 4 depending on which joystick port is in use. CONFIGUR 
will make it easy to select the proper version to meet your needs; it must be 
used to generate the XL versions. 

Page 4.2, SIOSIM versions: There are 12 versions of SIOSIM: 4 



. SIOSIM.nLM loads in low memory. 

. SIOSIM.nHM loads in high memory. ^ q 

. SIOSIM.nP6 loads in page 6. v . ; 

The XL version of PHANDLER also includes the code for SIOSIM. CONFIGUR 
should be used to select the SIOSIM version you need. 

Page 6.1, ICEGRAF versions: There are 20 possible versions of ICEGRAF (only the 
port 2 versions are on the diskette in ready-to-load format, CONFIGUR must be used 
to generate the other versions). In addition to those listed on page 6.1, there 
are versions for port 1 or 3, plus XL/XE versions. The XL/XE version loads into 
high memory and if BASIC is present, it "hides" under it in RAM (appears to use no 
memory) and will be swapped active whenever it is needed — a portion of the 
driver loads into the cassette handler code in OS to make the swap. The XL 
version MUST be generated by CONFIGUR; for best results, CONFIGUR should be used 
to generate any ICEGRAF driver. 

Page 7.1, Status Locations and Values: Port 1 Addresses are STRIG(O), PADDLE(O), 
and PADDLE(l). Port 3 addresses are STRIG(2), PADDLE(4) and PADDLE(5). 

Page 9.1, ICECHK Diagnostic: ICECHK 1 for port 1 and ICECHK3 for port 3. 

Page 9.3: REBOOT will not clear a page below 7 if it contains an ICEPIC driver. 
The REBOOT function is built into the XL drivers. 

Page 9.4, New Utility Programs: 


CONFIGUR is a menu-driven selection program which performs the selection, copying, 
appending, and renaming of driver programs. To use it, load CONFIGUR from the 
ICEPIC diskette, make your desired selections, and insert your target diskette 
when CONFIGUR calls for it. CONFIGUR will allow you to select drivers by 
application (for the sample applications) or you can specify your own custom 

„- 2 - 

requirements. It is quite friendly and allows you to change your mind and back up 
at any point. It has only a few limits: the ICEPIC software diskette must be in 
drive 1 and any application which is being appended to an ICEPIC driver must 
reside on the target diskette or be on another drive (DO NOT SWAP diskettes during 
the append operation). CONFIGUR must be used to generate XL drivers and to 
generate ICEGRAF for any port except 2 — we recommend that CONFIGUR always be 
used, it greatly simplifies the job of selecting and copying a driver. CONFIGUR 
always writes a driver named ICEPIC. TMP and when this completes, it renames it to 
your specified name (and it lets you rename or delete any program which previously 
exists under that name). This mode of operation assures that nothing is lost if 
an error occurs and allows you to append an existing program to a driver and 
create a new program with the same name as the original (AUTORUN.SYS, for 
example). You should always save (via CONFIGURE rename option) any application 
program you append and replace — if you need to create a new driver you will need 
the original program (DO NOT "reuse" an ICEPIC driver as an appended program). 


The RAMOS program copies the XL/XE operating system (OS) from ROM into RAM and 
makes several modifications to it. CONFIGUR appends XL drivers to RAMOS to create 
the driver you request. The modified OS implements the [BREAK] functions for 
system reset and reboot (see Page 3.3 above) ~ this is required because the 
normal [RESET] key will always switch OS back into ROM and turning the power off 
will clear RAM. To make sure you can press [BREAK], it will be enabled at all 
times ~ some applications may try to disable it, but probably will not succeed. 
DO NOT press [OPTION] during a reboot, the original power-up BASIC mode (active or 
not) will be maintained, but it cannot be changed. RAMOS will also disable the 
cassette handler — cassette I/O should not be used with the XL/XE drivers (the XL 
drivers are loaded into the memory normally used by the cassette handler). RAMOS 
will only work with the standard Atari XL/XE ROM OS — it cannot be used with 
translator's, ROM "fixers", or any program which itself modifies OS (on purpose 
like PaperClip, or by accident(?) like Print Shop). 

Page 10.1, BASIC Programs: On XL/XE models, the XL version of ICEGRAF is best, it 
does everything and costs nothing — CONFIGUR must be used to make it. 

Page 10.3, LJK Letter Perfect: Step 1: Use SIOSIM.nHM; on XL/XE models use 
PHANDLER.nXL. Step 2: For XL/XE, press "reboot" key (see page 3.3 above). Step 
3: not needed, (the driver will be lost on [SYSTEM RESET]; on XL's, use 
[SHIFT ]-[BREAK] for reset). ICEGRAF can still be used, as documented; however, it 
uses 4096 bytes of memory while SIOSIM.nHM will only use 512 bytes and the XL 
version uses no additional memory. 

Page 10.3, B/GRAPH, Step 1: On XL/XE models, use the XL version of ICEGRAF (use 
CONFIGUR to make it) — all of the ICEGRAF functions will be available while 
running B/GRAPH. 

Page 10.4, Koala, disk based, Step 4 should read "Copy IGEGRAF.xnH ...". 

Page 10.5, new sample applications: 

Print Shop ~ use PHANDLER.nPS plus REBOOT. 
PaperClip — use PHANDLER.nP6 plus REBOOT. 

- 3 -